home *** CD-ROM | disk | FTP | other *** search
/ Aminet 2 / Aminet AMIGA CDROM (1994)(Walnut Creek)[Feb 1994][W.O. 44790-1].iso / Aminet / text / tex / TeX_README < prev    next >
Text File  |  1993-12-29  |  6KB  |  148 lines
  1. This file should help you choose which archive(s) to get if you want
  2. to use TeX 3.141 based on this port. 
  3.  
  4. Please send complaints, bug reports, etc. to dcc@dcs.ed.ac.uk or by
  5. post to David Crooke, 2 Main St., Carnock, Dunfermline, Fife, SCOTLAND
  6. KY12 9JQ.
  7.  
  8. *******************************************************************
  9. * STOP PRESS                                                      *
  10. *                                                                 *
  11. * This should now work under AmigaOS 3.0 with the appropriate     *
  12. * version of ixemul.library.                                      *
  13. *                                                                 *
  14. * Dave                                                            *
  15. *******************************************************************
  16.  
  17. *******************************************************************
  18. * The infamous "etc" message                                      *
  19. *                                                                 *
  20. * One thing that isn't mentioned in the documentation is that you *
  21. * need a large stack size in your AmigaShell in order to build    *
  22. * and use LaTeX. You can obtain this by using the STACK command   *
  23. * before commencing work with initex:                             *
  24. *                                                                 *
  25. *   6.Workbench3.0> stack 100000                                  *
  26. *                                                                 *
  27. * (I think 100,000 bytes is enough). If the stack is too small,   *
  28. * you may get the following, confusing requestor from the ixemul  *
  29. * library:                                                        *
  30. *                                                                 *
  31. *   --System Request--------------                                *
  32. *   |                            |                                *
  33. *   | Please insert volume       |                                *
  34. *   | etc                        |                                *
  35. *   | in any drive               |                                *
  36. *   |                            |                                *
  37. *   | Retry               Cancel |                                *
  38. *   ------------------------------                                *
  39. *                                                                 *
  40. * To alleviate this problem, just increase the stack size and try *
  41. * again.                                                          *
  42. *                                                                 *
  43. * 17-Nov-93                                                       *
  44. * Dave                                                            *
  45. ******************************************************************* 
  46.  
  47.  
  48. ---------------------------------------------------------------------
  49.  
  50. Description
  51. -----------
  52.  
  53. TeX 3141 is a port of the latest (as far as I know) version of Knuth's
  54. generic TeX engine for AmigaDOS, with a little hack of my own so that
  55. the memory size can be controlled by the user and altered without
  56. recompilation.
  57.  
  58. Credits
  59. -------
  60.  
  61. Literally 99.9% of the work put in this software was done by other
  62. people, not me. In particular, Markus Wild, who ported the GCC
  63. compilers to the Amiga, the many people who did the Unix port of TeX
  64. on which this is based, Leslie Lamport, author of LaTeX, and most of
  65. all Donald Knuth, the originator of TeX and author of the vast
  66. majority of this code.
  67.  
  68. Disclaimer
  69. ----------
  70.  
  71. This port has not been thoroughly tested, but I can't forsee many
  72. problems. If there are any I will endeavour to resolve them but this
  73. software is for use entirely at your own risk, no warranty expressed
  74. or implied, etc., etc. 
  75.  
  76. Machine Requirements
  77. --------------------
  78.  
  79. To run this code, you will need:
  80.  
  81.    - An Amiga (really ?) with at least 2Mb of RAM 
  82.    - AmigaDOS 1.3 or higher
  83.    - Version 39 or higher of Markus Wild's ixemulib.library, available
  84.      from all good Amiga ftp sites. If you have GCC 2.3.3 you have
  85.      this already.
  86.  
  87. Hard disks, lots of memory, better versions of AmigaDOS etc. are all
  88. highly desirable.
  89.  
  90. Packages
  91. --------
  92.  
  93. TeX3141UserKit.lha - for first-timers
  94.  
  95. This contains all you need for a bare-bones installation of TeX and
  96. LaTeX, including font metrics, style files, and the .tex sources for
  97. TeX and LaTeX. It does not include the software to view, process or
  98. print the DVI files that TeX produces, nor any information on using
  99. TeX, but it does have advice on what else to get and where to get it.
  100. If you have a 32-bit processor and FPU and want to take advantage of
  101. them, get TeX3141bin881.lha as well and use the executables contained
  102. therein. 
  103.  
  104.  
  105. TeX3141bin.lha - for existing users
  106.  
  107. This contains just the executables for initex and virtex and the
  108. tex.pool file. Documentation for my memory hack is provided.
  109.  
  110. *WARNING* - you will need to redump your format files (e.g.
  111. "lplain.fmt" for LaTeX), so make sure you have .tex files for them
  112. before you install this! If you don't, but it is just TeX and/or LaTeX
  113. you need, get the user kit (above), it includes them.
  114.  
  115.  
  116. TeX3141bin881.lha - for well-endowed users
  117.  
  118. This is the same as the TeX3141bin.lha version, but the executables
  119. have been compiled for 68020/68881 or higher processors. They should
  120. work with any high-end Amiga (all existing models of A3000 and
  121. A4000/040), and any accelerator which has an FPU (68881, 68882 or full
  122. 68040). If you have an accelerator with no FPU, or a bare A1200 or
  123. A4000/030, use the above versions - don't feel cheated, the extra
  124. speedup comes mainly from the FPU, not the 68020 instructions; of
  125. course you will still benefit from having the faster integer
  126. processor.
  127.  
  128. The speedup of this against the above 68000 version, LaTeXing my
  129. flatmate's latest lab. report on my A3000/25, is about 30%. Your
  130. mileage may vary ;-)
  131.  
  132. See the description of TeX3141bin.lha as well.
  133.  
  134.  
  135. TeX3141source.lha - for expert masochists only
  136.  
  137. This is the source from which the initex/virtex executables were
  138. built, including web2c, etc. and the source for my hack. Only get this
  139. if you want to tinker with the works. No user serviceable parts
  140. inside. The makefiles, etc., (what little there is in the way of such
  141. luxuries) assume Markus' port of GCC.
  142.  
  143.  
  144. Happy TeXing
  145. Dave
  146. 1-Mar-93, updated 17-Nov-93
  147.  
  148.